docs: rebuild the introduction as a real front door - #2885
Merged
Conversation
Make /introduction the single "What is HyperFrames?" page a stranger can be sent, and retire the switchboard that sat in front of it. - introduction: lead with one sentence + a sound-on result (drop `muted`), simplify the loop diagram to request -> agent -> project -> video, cut the fake "See how it works" scroll button, and replace the equal-weight card walls with one clear "Start here" action. - guides/index: remove the six-card "What do you need to do?" menu-of-menus. The nav already routes people and /introduction is the real entry point. Redirect /guides -> /introduction. - developers: point the "create a video" link at /quickstart. mint validate and mint broken-links both pass.
ukimsanov
marked this pull request as ready for review
July 29, 2026 19:39
ukimsanov
merged commit Jul 29, 2026
96533da
into
codex/docs-human-first-refactor
14 of 15 checks passed
There was a problem hiding this comment.
Pull request overview
Rebuilds the docs /introduction page into a single “front door” overview of HyperFrames, removes the old Guides landing page from navigation, and updates related entry-point links/redirects to steer new users toward the new intro and quickstart.
Changes:
- Reworked
docs/introduction.mdxto lead with a concise value statement, a playable (with sound) example video, a simplified “request → agent → project → video” loop, and a clearer “Start here” CTA set. - Removed the old “What do you need to do?” Guides index page and removed it from the “Start here” nav group.
- Added a
/guides → /introductionredirect and repointed the Developers entry link toward/quickstart.
Reviewed changes
Copilot reviewed 4 out of 4 changed files in this pull request and generated 1 comment.
| File | Description |
|---|---|
| docs/introduction.mdx | Rewritten “What is HyperFrames?” page with a stronger lead, proof video, simplified loop, and clearer next-step actions. |
| docs/guides/index.mdx | Removes the Guides landing content (retiring the “menu-of-menus” entry page). |
| docs/docs.json | Drops guides/index from nav and adds a redirect from /guides to /introduction. |
| docs/developers/index.mdx | Updates the “create/edit a video” entry link to point to /quickstart instead of /guides. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Comment on lines
513
to
+517
| "redirects": [ | ||
| { | ||
| "source": "/guides", | ||
| "destination": "/introduction" | ||
| }, |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What this does
Rebuilds
/introductionas the single "What is HyperFrames?" page you can send a stranger, and retires the switchboard that sat in front of it. Stacked on top of the docs refactor branch so this shows only the delta.Changes
introduction.mdx— lead with one sentence + a real result that plays with sound (droppedmuted); simplify the loop diagram torequest → agent → project → video; remove the "See how it works" button that only scrolled the page; replace the equal-weight card-walls with one clear Start here action.guides/index.mdx— removed the six-card "What do you need to do?" menu-of-menus. The nav already routes people and/introductionis the real entry point. Added/guides → /introductionredirect.developers/index.mdx— repoint the "create a video" link at/quickstart.Why
Rebuilds the front door around real user journeys (a proposal + interactive prototype were prepared separately for leadership). The old intro asked a cold visitor to triage themselves through six identical cards before seeing any proof; this shows the product first.
Validation
mint validate✅mint broken-links✅Draft — direction pending leadership sign-off on the journeys.